<html>
<head>
  <title>NewsBlur Help</title>
  <style type="text/css">
    body {
      font-family: Nokia Pure Text Light;
      background-color: #E0E1E2;
    }
    h1 {
      font-size: 24px;
    }
    p {
      font-size: 24px;
    }
    li {
      font-size: 24px;
    }
    img.floatLeft { 
      float: left; 
      margin-right: 16px; 
      margin-bottom: 16px; 
    }
    img.floatRight { 
      float: right; 
      margin-left: 16px; 
      margin-bottom: 16px; 
      clear: true      
    }
    .positive {
      color: #008000
    }
    .negative {
      color: #ff0000
    }
    .neutral {
      color: #ff8c00
    }
  </style>
</head>
<body>
  <img src="newsblur_help_files/logo_newsblur.png"/ >
  <p>NewsBlur, created by Samuel Clay, is an open-source RSS feed reader, 
  offering an intelligent way to find stories you like and those you do not. NewsBlur automatically classifies
  every story based on the state of user editable intelligence classifiers. There are three types of possible classifications:
    <ul>
      <li>negative classification - highlighted with <span class="negative">red</span></li>
      <li>neutral classification - highlighted with <span class="neutral">orange</span></li>
      <li>positive classification - highlighted with <span class="positive">green</span></li>
    </ul>
  </p>  
  
  <h1>Feeds and folders</h1>
  <img src="newsblur_help_files/special_feeds_small.png" class="floatRight"/ >
  <p>After a successful account creation the list of subscribed feeds is empty, however there
  are two special feeds that will be instantly visible. The <em>Everything</em> feed, unlike the regular feeds, contains stories
  from multiple feeds which are not read yet. If there are no unread stories at all, this feed is empty. The <em>Saved stories</em> feed
  contains the stories which are marked as saved. It's a useful feature in cases when you find an interesting story
  but you don't want or can't read it instantly. The <em>Saved stories</em> feed allows you to find these stories easily at a later time.</p> 
  <p>Feeds can be either added directly to the list of subscriptions or they can be organized hierarchically into folders.
  To add a new feed or to add a new folder press the '+' icon on the toolbar. New feeds and folders are always added to 
  the folder that is currently visible in the view. A new feed can be added by either entering the full address of the feed,
  or by entering just search terms describing the feed. In the later case you'll get a list of suggestions from NewsBlur, select the
  one that you think is the best match and press the <em>Add</em> button. To add a new folder, just enter the new folder's name and press the
  <em>Add</em> button.</p>
  <img src="newsblur_help_files/menu_small.png" class="floatLeft"/ >
  <p>Existing feeds and folders can be modified and reorganized in a number of ways. These operations can be reached from the main menu
  or from the context menu of feed and folder items. An item's name can be modified by selecting the <em>Rename</em> item from the menu. Enter a new name for the item and press the <em>Rename</em> button.
  To delete an item, just select the <em>Delete</em> menu item. To modify the position of a feed or a folder item in the folder hierarchy select
  the <em>Move to</em> menu item, and a folder from the list of the available options. An item can be moved to any folder, except to it's current
  parent folder and to any of it's child folders.</p>
  
  <h1>Stories</h1>
  <img src="newsblur_help_files/countbubble.png" class="floatLeft"/ >
  <p>The number of unread stories for every feed in the current folder or for the current feed in the view is displayed in the top left corner
  of the page header, and also separately for every item in the list. If there are no unread stories, no unread count is displayed. The number of unread 
  stories are displayed separately for every classification. The number of neutrally classified stories are marked with <span class="neutral">orange</span> color, the number of
  negatively classified or disliked stories is marked with <span class="negative">red</span> and the number of positively classified stories or the stories you might like
  is marked with <span class="positive">green</span> color.</p>
  <p>The stories of a particular feed can be viewed by entering the feed. If you enter a feed the list of stories is initially empty until the 
  first batch of stories is loaded. Whenever the app loads a new batch of stories, a wait indicator is displayed in the page header. Whenever new
  stories for the given feed appear, they are automatically loaded and prepended to the list of stories. The contents of the stories are cached to
  speed up the browsing of feeds. The number of stories that are allowed to be cached can be adjusted in the settings of WebFeeds. The <em>Everything</em>
  feed is an exception. Due to the way NewsBlur updates feeds, stories in the <em>Everything</em> feed can't be reliably cached. The stories in
  this feed are just partially updated, new stories are loaded whenever they appear, but unread stories can also appear with older dates. So
  whenever you want to make a complete update of the list of unread stories, press the refresh button in the toolbar.</p>  
  <img src="newsblur_help_files/classification_small.png" class="floatRight"/ >
  <p>The classification of stories in a feed is indicated with horizontal lines on the left side of the story items with the same colors as the number
  of unread stories are marked. Unread stories are marked with brighter colors, the stories that are already read are marked with dimmer colors.
  If a story is saved, the story item is marked with a star.</p>
  <img src="newsblur_help_files/filter_options_small.png" class="floatLeft"/ >
  <p>In the feed view stories can be filtered by their classification. The current filter in use is indicated by the colors of the count
  bubble in the page header. The classification of hidden stories are highlighted with gray color instead of their original highlight color
  like red or orange. The filtering method can be changed by pressing the page header and selecting a different filter.</p>
  <p>To view the contents of a story press the story item in the list. To view the next or previous story in the feed swipe right or left.
  Stories can be saved or unsaved by pressing the star icon in the toolbar. Stories can be shared with any of your accounts which allows
  sharing of links, by pressing the share button on the toolbar. Read stories can also be marked as unread from the menu.</p>
  <p>To mark every story of a single or multiple feeds as read, press the check mark button in the toolbar. When it's pressed inside a feed
  every story of the current feed will be marked as read, pressing it inside a folder will mark every story of the current folder's child
  feeds as read, pressing it in the root folder of NewsBlur or in the <em>Everything</em> feed will mark every story in every feed as read.</p>
  
  <h1>Intelligence trainer</h1>    
  <p>The classifications of existing and future stories are determined by the state of intelligence classifiers of their feeds. Intelligence classifiers
  can be modified by opening the <em>Intelligence trainer</em> from the menu. When opened inside a feed every classifier of the current feed is displayed,
  when opened inside a story only the classifiers related to the current story are displayed. Three types of classifiers are available:
    <ul>
      <li>Title classifiers - affect the classification of stories which title contains the text of the classifier.</li>      
      <li>Author classifiers - affect the classification of stories with the given author.</li>
      <li>Tag classifiers - affect the classification of stories marked with the given tag.</li>
      <li>Feed classifiers - affect every story related to the given feed.</li>      
    </ul>
  </p>
  <img src="newsblur_help_files/classifier_small.png" class="floatRight"/ >
  <p>As mentioned earlier, classifiers can take three values, <span class="negative">negative</span>, <span class="neutral">neutral</span> 
  and <span class="positive">positive</span>. To change the value of a classifier press the dislike button on it's left to give it a 
  <span class="negative">negative</span>, press it in the center to give it a <span class="neutral">neutral</span> or press the like button
  on it's right to give it a <span class="positive">positive</span> value.
  The actual classification of a story is determined by the following rules:
    <ol>
      <li>if there is at least one title, author or tag classifier with a <span class="positive">positive</span> value related to
      the given story, it's classification is <span class="positive">positive</span></li>
      <li>if there is at least one title, author or tag classifier with a <span class="negative">negative</span> value related to
      the given story, it's classification is <span class="negative">negative</span></li>      
      <li>if there are no title, author or tag classifiers with a <span class="positive">positive</span> or <span class="negative">negative</span> value related to
      the given story, it's classification is equal to the value of the feed classifier.</li>
    </ol>
  </p>
</body>
</html>
